*>*■ 


tlxll 

anil 


US  Army  Corps 

of  Engineers 


1  .. 

i  <5S r**i  i 

Wl.AW  - 

vn iw» 


INSTRUCTION  REPORT  K-84-3 


% 


USER’S  GUIDE:  MODIFIED  SLOPE 
STABILITY  PACKAGE  WITH  KANSAS  CITY 
ANALYSIS  (DGSLOPE) 


Robert  L.  Hall.  Michael  E.  Pace 


Automatic  Data  Processing  Center 
U.  S.  Army  Engineer  Waterways  Experiment  Station 
P.  O.  Box  631,  Vicksburg,  Miss.  39180 


January  1984 
Final  Report 


Approved  For  Public  Releaae;  Distribution  Unlimited 


DT! 

EL<- 


APR  2  0 1984 


prepared  for  Office,  Chief  of  Engineers,  U.  S.  Army 
Washington,  D.  C.  20314 


84  04 


04  20  010 


Oestroy  this  report  when  no  longer  needed.  Do  not 
return  it  to  the  originator. 


The  findings  in  this  report  are  not  to  be  construed  as  an 
official  Department  of  the  Army  position  unless  so 
designated  by  other  authorized  documents. 


This  program  is  furnished  by  the  Government  and  is 
accepted  and  used  by  the  recipient  with  the  express 
understanding  that  the  United  States  Government  makes 
no  warranties,  expressed  or  implied,  concerning  the 
accuracy,  completeness,  reliability,  usability,  or  suitability 
for  any  particular  purpose  of  the  Information  and  data 
contained  in  this  program  or  furnished  in  connection 
therewith,  and  the  United  States  shall  be  under  no  liability 
whatsoever  to  any  person  by  reason  of  any  use  made 
therer;.  The  program  belongs  to  the  Government. 
Therefore,  the  recipient  further  agrees  not  to  assert  any 
proprietary  rights  therein  or  to  represent  this  program  to 
anyone  as  other  than  a  Government  program. 


The  contents  of  this  report  are  not  to  be  used  for 
advertising,  publication,  or  promotional  purposes. 
Citation  of  trade  names  does  not  constitute  an 
official  endorsement  or  approval  of  the  use  of  such 
commercial  products. 


Unclassified 


SECURITY  CLASSIFICATION  of  THIS  PACE  (Whrni  Data  Bntarad) 


j  REPORT  DOCUMENTATION  PAGE 

READ  INSTRUCTIONS 

BEFORE  COMPLETING  FORM 

4.  TITLE  (mtd  Suhtltla) 

USER'S  GUIDE:  MODIFIED  SLOPE  STABILITY  PACKAGE 
WITH  KANSAS  CITY  ANALYSIS  (DGSLOPE) 

S.  TYPE  OF  REPORT  A  PERIOD  COVERED 

Final  report 

6.  PERFORMING  ORG.  REPORT  NUMBER 

7.  AUTHOR^.; 

Robert  L.  Hall 

Michael  E.  Pace 

8.  CONTRACT  OR  GRANT  NUMBER!.; 

>.  PERFORMING  ORGANIZATION  NAME  AND  ADDRESS 

U.  S.  Army  Engineer  Waterways  Experiment  Statioi 
Automatic  Data  Processing  Center 

P.  0.  Box  631,  Vicksburg,  Mississippi  39180 

It.  CONTROLLING  OFFICE  NAME  AND  ADDRESS 

Office,  Chief  of  Engineers,  U.  S.  Army 
Washington,  D.  C. ,  20314 

12.  REPORT  DATE 

January  1984 

19.  NUMBER  OF  PAGES 

50 

M.  MONITORING  AGENCY  NAME  A  ADDRESS!!!  dlltarant  ham  Can  hailing  Olllea) 

is.  SECURITY  CLASS.  (0/  thl»  report) 

Unclassified 

IS.  DISTRIBUTION  STATEMENT  (ol  Ml*  RapZrt) 


Approved  for  public  release;  distribution  unlimited 


17.  DISTRIBUTION  STATEMENT  (at  Ota  abattael  an t trad  In  Stack  29,  II  4Maaant  ham  Report; 


IS  SUPPLEMENTARY  NOTES 

Available  from  National  Technical  Information  Service,  5285  Port  Royal  Road, 
Springfield,  Va.  22161 


IS.  KEY  BOROS  (Canttnua  an  taaaraa  alda  II  naaaaaant  mtd  Idantlfy  hr  Woe*  ranker; 

Conversational  mode  Failure  surface  data 

Critical  pool  Kansas  City  format 

DG SLOPE  Partial  pool 

Drawdown  Slope  stability  program 

Drum  plots  Soil  profile 


Stability  analysis 
WESLIB  format 


SB.  ABSTRACT  rr»l>on  —  raaaaaa  at*  H  naaaaaary  and  Idaalttr  hr  Woe*  ntmihar) 

—  This  report  Is  a  user's  guide  for  DSGLOPE,  a  package  of  slope  stability  anal¬ 
ysis  programs  with  Interactive  graphics  and  drum  plot  capabilities.  Five 
existing  slope  stability  programs  form  the  DGSLOPE  package.  Three  of  these 
cane  from  the  U*  S.  Army  Engineer  Waterways  Experiment  Station  (WES)  computer 
program  library,  WESLIB.  The  two  additional  slope  stability  programs  came 
from  the  U.  S.  Army  Kansas  City  District  Office.  Two  of  these  programs  (SSA003 
(WES)  and  KCARC  (KC)  utilise  the  circular  arc  method  of  analysis:  the  other 
three  (SSW028(WES) ,  SSW39A  (WES)  and  KCWED  (KC))  employ  the  wedge  method.. 


DO  /£”»  1473  EtNTlOM  OF  I  MOV  ••  It  OBSOLETE 


Unclassified 


SECURITY  CLASSIFICATION  OF  THIS  PAT.e  fBkrtl  Data  Bntarad) 


PREFACE 


This  report  provides  Instructions  for  using  DGSLOPE,  an  interactive  com¬ 
puter  graphics  slope  stability  package  with  drum  plot  capabilities.  An  exist¬ 
ing  series  of  slope  stability  programs  (SSA003,  SSW028,  and  SSW39A)  was 
combined  to  form  the  original  DGSLOPE.  The  Kansas  City  series  of  slope  stabil¬ 
ity  programs  has  recently  been  added  to  DGSLOPE.  This  latest  work  is  a  joint 
effort  between  the  U.  S.  Army  Engineer  Waterways  Experiment  Station  (WES)  and 
the  U.  S.  Army  Engineer  Division.  Lower  Mississippi  Valley  (LMVD)  computer 
center  for  fiscal  year  1983.  Part  of  this  work  was  initiated  and  funded  during 
fiscal  year  1980  by  the  Computation  and  Analysis  Branch  Office,  Chief  of 
Engineers  (OCE) . 

The  programs  SSA003,  SSW039A  and  SSW028  were  developed  by  Mr.  James  B. 
Cheek,  formerly  of  the  WES  Automatic  Data  Processing  (ADP)  Center.  The  analyt¬ 
ical  procedures  have  been  reported  by  Mr.  Cheek  in  WES  Miscellaneous  Papers 
K-73-2,  K-76-3,  and  K-77-1. 

The  original  DGSLOPE  was  primarily  constructed  by  Mr.  Robert  L.  Hall,  ADP 
Center.  Ms.  Janet  Jackson,  ADP  Center,  assisted  In  coding  and  testing  the 
original  code.  Mr.  James  Jones,  ADP  Center,  provided  axis  routines  that  were 
used  for  the  drum  plot.  Mr.  Michael  Pace  did  considerable  work  in  testing  the 
original  program  and  has  recently  completed  the  major  part  of  adding  the 
Kansas  City  package  to  DGSLOPE. 

The  Kansas  City  slope  stability  package  was  developed  by  Mr.  Richard 
Davidson,  then  of  the  Kansas  City  District.  The  package  was  documented  in 
the  Kansas  City  District  publication,  "Program  Writeup  for  Slope  Stability 
Analysis".  The  revised  report  was  published  in  January  1976. 

The  original  user’s  guide  was  prepared  by  Mr.  Hall  and  Mr.  Paul  K.  Senter, 
ADP  Center,  using  major  parts  of  the  command  description  as  reported  earlier 
by  Mr.  Cheek. 

This  user's  guide  was  prepared  by  Mr.  Pace  and  Mr.  Hall  and  includes  much 
of  the  original  user's  guide. 

The  U.  S.  Army  Engineer  District,  Vicksburg, provided  technical  guidance 
for  the  work  on  the  package.  Liaison  was  maintained  between  the  District  and 
WES  by  means  of  telephone  conversations  and  office  visits  with  Messrs.  Larry  A. 
Cooley  and  Eugene  G.  Wardlaw,  Foundation  and  Materials  Branch.  Mr.  Tony  Young, 


Geology,  Soil*  and  Materials  Branch,  wee  the  LMVD  point  of  contact.  Dr.  N. 
ladhahrlahnan  was  technical  coordinator  of  the  work. 

Co— ander  and  Director  of  WES  during  the  preparation  and  publication  of 
this  report  mi  00L  Tilford  C.  Creel,  CE.  Technical  Director  was  Mr.  Fred  R. 
Broun. 
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CONVERSION  FACTORS,  U.  S.  CUSTOMARY  (NON-SI)  TO  METRIC  (SI) 

UNITS  OF  MEASUREMENT 

U.  S.  Cu 8 tomary  (SI)  units  of  measurement  used  In  this  report  can  be  converted 
to  metric  (SI)  units  as  follows: 


Inches 

pounds  (force)  per  square  foot 
pounds  (mass) 

pounds  (mass)  per  cubic  foot 


0.3048 

2.54 

47.88026 

0.45359237 

16.01846 


To  Obtain _ 

meters 

centimeters 

pascals 

kilograms 

kilograms  per  cubic  meter 


USER'S  GUIDE:  MODIFIED  SLOPE  STABILITY  PACKAGE 
WITH  KANSAS  CITY  ANALYSIS  (DGSLOPE) 

PART  I:  INTRODUCTION 


Purpose 


1*  This  report  Is  a  user's  guide  for  DGSLOPE,  a  package  of  slope  stabil¬ 
ity  analysis  programs  with  Interactive  graphics  and  drum  plot  capabilities. 

The  package  consists  of  five  slope  stability  analysis  programs.  Three  existing 
slope  stability  programs  In  the  U.  S.  Army  Engineer  Waterways  Experiment 
Station  (WES)  computer  program  library,  WESLIB,  and  two  Kansas  City  programs 
were  combined  to  form  the  DGSLOPE  package.  The  first  of  the  three  WESLIB 
programs  (SSA0O3*)  utilizes  the  circular  arc  method  of  analysis;  the  other  two 
(SSW028**  and  SSW39A^)  employ  two  different  wedge  methods  of  analysis.  One  of 
the  Kansas  City  programs  uses  a  wedge  method,  while  the  other  uses  the 
circular  arc  method  of  analysis  both  of  which  perform  an  automatic  search 
for  a  minimum  safety  factor. 

& 

Scope 


Input  Features 

2.  The  DGSLOPE  package  is  easy  to  work  with  because  It  allows  the  user  to 
interact  with  the  program  in  a  conversational  manner.  It  does  not  force  the 
user  to  follow  a  sometimes  inefficient  data  preparation  procedure;  rather.  It 
allows  him  to  dictate  the  program  action  using  a  series  of  simple  commands. 


*  Cheek,  J.  B.  1973.  "Instruction  Manual  for  Using  WES  Time-Sharing  System 
for  Analysis  of  Slope  Stability  (The  Circular  Arc  Method)",  Miscellaneous 
Paper  K-73-2,  U.  S.  Army  Engineer  Waterways  Experiment  Station,  Vicksburg, 
Ml88. 

**  .  1976.  "Instruction  Manual  for  Using  Time-Sharing  System  for 

Analysis "of  Slope  Stability;  Wedge  Method",  Miscellaneous  Paper  K-76-3, 

U.  S.  Army  Engineer  Waterways  Experiment  Station,  Vicksburg,  Miss. 

t  .  1977.  "Analysis  of  Slope  Stability,  Wedge  Method  Using  Head 

Profiles  to  Model  Uplift  Pressures",  Miscellaneous  Paper  K-77-1,  U.  S.  Army 
Engineer  Waterways  Experiment  Station,  Vicksburg,  Miss. 

Davidson,  R.  F.  1976.  "Program  for  Slope  Stability  Analysis",  U.  S.  Army 
Corps  of  Engineers,  Kansas  City  District,  Kansas  City,  Mo. 
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3.  The  program  assists  the  user  In  preparing  Input  data  In  two  ways: 

(1)  by  displaying  the  Input  graphically  as  it  is  being  defined,  thereby  allowing 
visual  monitoring  of  Information  that  has  been  input  and  (2)  by  prompting  the 
user  with  data  preparation  Instructions  printed  at  the  terminal  following  each 
command.  To  speed  the  input  process  on  the  time-sharing  system,  the  user  can 
Input  data  from  a  previously  prepared  data  file. 

4.  DGSLOPE  checks  the  input  data  and  prints  error  messages  if  the  data 
violate  program  requirements.  Since  this  feature  does  not  guarantee  the 
accuracy  of  the  data,  the  program  has  commands  which  allow  the  user  to  change 
much  of  the  input. 

Output 

5.  DGSLOPE  provides  plots  from  a  graphics  storage  tube  terminal  and  a  drum 
plotter.  For  the  three  WESLIB  programs  previously  mentioned,  a  plot  of  the 
water  profile,  soil  profile,  and  failure  surface  may  be  obtained  after  each 
stability  analysis  is  complete.  Upon  completion  of  all  analyses,  the  user  can 
obtain  a  drum  plot  displaying  the  soil  profile  and  failure  surface  for  any  or 
all  of  the  individual  analyses.  The  drum  plot  capability  applies  to  all  the 
programs  in  the  package. 


PART  II:  OPERATING  PROCEDURE 

Overview 

6.  Although  each  facet  of  the  operating  procedure  will  subsequently  be 
covered  in  detail,  the  following  overview  of  the  procedure  describes  how  the 
facets  Interact. 

7.  Seated  at  the  Tektronix  4014  terminal  or  its  equivalent,  the  user  calls 
the  computer,  identifies  himself,  and  requests  a  run  of  DGSLOPE.  The  program 
asks  for  the  name  of  a  restart  file  (this  file  will  be  used  to  save  the  data 
used  as  input  for  the  last  stability  calculations).  The  program  then  requests 

a  data  title,  which  the  user  supplies  (this  title  will  be  stored  in  the  first 
line  of  the  restart  file  for  identification  purposes).  The  program  then  asks 
for  a  command  which  the  user  supplies.  Through  this  and  subsequent  commands, 
the  program  does  any  or  all  of  the  following :  receives  or  alters  soil  proper¬ 
ties,  so 11  profiles,  pool  elevation,  and  neutral  block  base  points;  modifies 
the  computational  procedure;  and  evaluates  stability  for  the  data  stored. 

DGSLOPE  also  displays  soil  profiles,  pool  elevation,  piezometrlc  head  points, 
neutral  blocks,  arcs,  and  the  phreatic  profile.  After  investigating  several 
^allure  surfaces,  the  user  may  find  it  necessary  to  sign  off  and  attend  to 
other  duties,  even  though  he  has  not  completed  his  analysis.  He  may  do  so 
without  fear  of  losing  his  data  because  all  the  data  items  used  in  the  last 
analysis  are  stored  by  the  program  in  the  restart  file.  They  are  ready  for 
use  when  he  next  has  an  opportunity  to  work  on  the  problem. 


8.  The  following  sequence  of  commands  will  start  DGSLOPE  time-sharing 
execution  on  the  Honeywell  DPS-1  (user  responses  are  underlined) : 

SYSTEH:  FORT  N 
READY 

*RUN  WE SL IB / DGSLOPE. R 

9.  The  program  now  has  control  of  the  terminal  and  after  a  pause  (whose 
length  depends  on  the  number  and  type  of  other  time-sharing  problems)  will  type: 
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or  m  ^  *'.**■*' w,.  yr*  swst  yy?-*?  *>  -:* 


SLOPE  STABILITY  ANALYSIS  PACKAGE  WITH  DRUM  PLOTS 
SUPPLY  NAME  OF  RESTART  FILE 


The  user  then  types  in  the  desired  file  name  and  a  carriage  return.  The  pro¬ 
gram  stores  the  file  name  and  erases  all  data  in  that  file.  Therefore  the  user 
either  must  give  a  new  (previously  unused)  file  name  or  be  sure  that  the  data 
stored  under  any  old  file  name  that  he  may  reuse  are  no  longer  needed. 

10.  After  this  file  is  established,  the  program  types 

SUPPLY  TITLE  FOR  THIS  RUN 

The  user  supplies  a  title  for  this  run  that  may  contain  up  to  60  characters 
(blanks  count  as  characters).  This  title  will  be  written  on  the  first  line 
of  the  restart  file  (Note  that  all  data  files  must  have  a  title  on  the  first 
line).  By  choosing  data  and  restart  file  names  in  a  systematic  manner,  such 
as  making  the  first  character  a  number,  the  user  will  be  able  to  easily  locate 
all  data  files  and  identify  them  by  their  title.  This  capability  is  most  use¬ 
ful  when  many  jobs  and  their  associated  files  are  being  processed.  Conse¬ 
quently,  the  user  must  be  sure  to  give  accurate,  meaningful  titles  to  his  runs. 

11.  After  the  title  is  saved,  the  program  types: 

ENTER  COMMAND  (LEVEL  1) 


The  user  may  now  begin  to  use  commands  to  enter,  display,  and/or  run  stability 

analyses.  "Level  1"  indicates  that  the  program  is  expecting  input  commands 

for  entering  data.  The  "Level  2"  commands  are  used  for  control  when  producing 

drum  plots  of  the  output.  If  the  user  enters  an  invalid  command,  the  program 

will  give  the  user  an  option  to  view  a  list  of  valid  commands.  If  the  user 

elects  to  view  the  list,  the  program  will  be  set  for  the  full  conversational 

mode  of  Interaction.  Note  the  following  example: 

ENTER  COMMAND  (LEVEL  1) 

■  xxxxx 

COMMAND  UNKNOWN 

DO  YOU  WISH  A  LIST  OF  VALID  COMMANDS  ?  ENTER  (Y  OR  N) 

-Y 

ARC  DATA 
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SOIL  DATA 
PROGRAM  CONTROL 
NEUTRAL  BLOCK 
EDIT  XXXX 
POOL  ELEVATIONS 
PHREATIC  PROFILE 
PIEZOMETRIC  HEAD 
INSERT  SOIL 
GENERATE  ARCS 
RUN  XXXX 

CONVERSATIONAL  OUTPUT 
NO  CONVERSATIONAL  OUTPUT 
TABLE  OF  SOIL  PROPERTIES 
READ  OLD  DATA  FILE 
WINDOW  PROFILE 
DISPLAY  PROFILE 

GAMMA  (UNIT  WEIGHT  OF  WATER,  PCF) 
PERCENT  CONSOLIDATION 
SLOPE  OF  ACTIVE  EARTH  FORCES 
SS  (SOIL  STRENGTH  CODE) 

RS  (RESTART) 

DELETE  XXXX 
STOP 

ENTER  COMMAND  (LEVEL  1) 


12.  At  this  point,  most  users  will  be  able  to  close  this  guide  and  follow 
the  Instructions  given  by  the  program  at  the  terminal.  However,  the  rest  of 
this  user's  guide  describes  what  can  be  expected  from  each  command  and  the 
restrictions  and  limitations  on  the  program  and  data.  A  list  of  all  commands 
with  brief  explanation  is  given  in  Appendix  A  to  aid  in  running  DGSLOPE. 
Optional  Output 

13.  The  user  can  call  up  detailed  data  preparation  Instructions  with  each 
data  input  command  code  by  using  the  full  conversational  mode.  The  output  of 
the  full  conversational  mode  for  each  command  is  shown  in  the  following  text 

in  capital  letters.  The  optional  output  giving  the  detailed  Instructions  is 
underlined  at.d  is  available  only  under  the  full  conversational  mode.  The  re¬ 
stricted  conversational  mode  will  print  only  the  non-underlined  text. 


% 


Soil  Profile  Data 


Soil  Input  Command  "  SO 

14.  This  command  is  used  for  all  five  programs  to  enter  the  coordinates 
and  soil  properties  of  each  individual  soil  profile. 
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vs 


15*  The  prograa  responds  to  command  SO  with: 


SOIL  1  PROPERTIES 

SATURATED _ Q  TEST _ R  TEST _ S  TEST 

UNIT  WT.. _ PHI.  COHESION.  PHI.  COHESION, _ PHI.  COHESION 

-  OR  - 

SAT.  WT,  MOIST  WT.  0  TEST(1  TO  3) _ R  TEST _ S  TEST 

PHI.  COHESION. _ PHI.  COHESION.  PHI.  COHESION 

16.  The  first  set  of  data  refers  to  the  WESLIB  programs,  while  the  second 
set  refers  to  the  Kansas  City  programs.  For  the  Kansas  City  programs,  the 
saturated  unit  weight  is  used  below  the  water  table,  and  the  moist  unit  weight 
is  used  above  the  water  table.  Up  to  3  sets  of  strength  parameters  may  be 
entered  for  the  Q  test. 

17.  The  user  should  type  in  the  saturated  unit  weight  and  moist  unit 
weight,  if  applicable,  in  pounds  per  cubic  foot;  the  Q,  R,  and  S  test  values 
for  the  friction  angle  (PHI),  in  degrees;  and  cohesion  (C),  in  pounds  per  square 
foot.  A  carriage  return  is  then  entered  to  save  the  material  properties  data. 

18.  If  the  user  wishes  to  switch  back  and  forth  between  the  various  pro¬ 
grams,  i.e. ,  from  the  WESLIB  programs  to  the  Kansas  City  and  vice  versa,  then 
the  data  should  be  input  in  the  Kansas  City  format.  The  Kansas  City  programs 
require  data  additional  to  that  required  for  the  WESLIB  programs.  Thus, 
entering  data  in  the  Kansas  City  format  will  satisfy  all  the  programs. 

19.  The  prograa  stores  the  properties  and  requests: 

SOIL  PROFILE 

X(l),  Y(l),  X(2).  Y(2),  ...  X(W).  KM) 

The  user  supplies  these  points  (distance  and  elevation.  In  feet)  on  the 
exterior  profile  in  ascending  order  by  distance  (X).  Note  that  this  exterior 
profile  must  extend  beyond  the  surface  Intersection  points  of  any  wedges  on 
acres  to  be  studied. 

20.  Should  more  than  one  line  of  data  be  required  for  the  profile,  the 


last  point  on  the  line  should  be  followed  by  a  comma  and  then  a  carriage  re¬ 
turn.  The  program  will  store  this  portion  of  the  profile.  When  the  program 
is  ready  for  the  remainder  of  the  data,  it  will  type  an  equal  sign  on  the 
next  line.  The  user  must  wait  for  the  equal  sign  before  supplying  additional 
points. 

21.  The  SO  command  is  used  repetitively  to  input  the  properties  and  pro¬ 
file  data  for  the  interior  soils.  The  program  numbers  each  new  soil  In  steps 
of  one,  starting  with  1  for  the  first  soil.  Soils  must  be  defined  working  from 
high  elevations  to  low,  because  each  profile  erases  all  portions  of  profiles 
below  it.  Any  valid  portion  of  a  profile  erased  by  this  procedure  must  be  re¬ 
defined  with  an  additional  lower  soil. 

22.  The  Kansas  City  program  requires  the  soil  profile  to  extend  the  entire 
length  of  the  section.  This  procedure  for  defining  the  soil  profile  will  be 
accepted  by  the  WESLIB  program.  However,  if  only  the  WESLIB  programs  are  used, 
profiles  may  begin  and/or  end  interior  to  the  section. 

23.  The  screen  is  erased,  and  all  data  are  displayed  after  each  soil 
profile  is  defined.  Following  is  the  input  for  the  first  soil  profiles. 


ENTER  COHHAND  (LEVEL  1) 

■SO 

SOIL  1  PROPERTIES 

SATURATED  Q  TEST  R  TEST  S  TEST 

UNIT  UT.,  PHI,  COHESION.  PHI.  COHESION,  PHI,  COHESION 

-  OR  - 

SAT.  UT.  HOIST  UT.  Q  TEST ( 1  TO  3  >  R  TEST  S  TEST 

PHI,  COHESION,  PHI,  COHESION.  PHI,  COHESION 

>125  ns  3e  e  30  e  30  e 

SOIL  PROFILE 

X(l>.  V(l).  X(2 ),  V(2 ),  ...  X(N),  V(N) 

—300  400  -250  400  -10  480  110  480 

The  first  profile  is  displayed  in  Figure  1. 


ENTER  COHRAND  (LEVEL  1) 


Figure  1.  Display  of  soil  1  data  using  SO  comnand 

The  input  for  the  second  profile  follows. 

ENTER  CONHAND  (LEVEL  1) 

-SO 


SOIL  2  PROPERTIES 

SATURATED  0  TEST  R  TEST  S  TEST 

UNIT  UT.,  PHI.  COHESION.  PHI,  COHESION.  PHI.  COHESION 

-  OR  - 


SAT.  UT.  HOIST  UT.  0  TEST ( 1  TO  3)  R  TEST  S  TEST 

PHI.  COHESION.  PHI.  COHESION,  PHI.  COHESION 
-150  MS  45  1000  30  2000  30  2500  45  5000  45  5000 


SOIL  PROFILE 


X(l),  V(l).  X(2 ).  V(2 >,  ...  X(N ).  V(N> 

—300  400  110  400 


The  display  for  both  profiles  is  shown  in  Figure  2. 

ENTER  CONHAND  (LEVEL  1) 
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The  soli  profiles  are  displayed  using  the  sane  scale  factor  in  both  the  X  and 
T  directions.  The  scale  factor  is  chosen  to  use  as  much  of  the  screen  as 
possible.  If  a  soil  profile  point  is  improperly  input,  the  X  and  Y  coordinates 
of  the  point  can  be  changed  using  the  EDIT  SOIL  (ED  SO)  command.  The  soil 
properties  can  be  changed  using  the  EDIT  MATERIAL  (ED  MA)  command. 

Failure  Surface  Data 

24.  The  following  commands  are  used  to  enter  failure  surface  data.  A 
total  of  25  failure  surfaces  may  be  entered  for  use  in  any  one  of  the  WESLIB 
programs.  Only  one  failure  surface  may  be  entered  at  a  time  for  use  in  the 
Kansas  City  programs.  Only  one  initial  failure  surface  is  needed  for  the 
Kansas  City  programs  because  additional  failure  surfaces  are  generated  in 
search  of  a  minimum  safety  factor. 

25.  Either  the  WESLIB  format  or  the  Kansas  City  format  may  be  used  to 
enter  data.  If  data  are  entered  in  the  Kansas  City  format,  the  WESLIB  programs 
may  also  be  run  on  the  same  data.  For  example.  If  the  soil  and  arc  data  are 
entered  in  the  Kansas  City  format,  the  user  may  also  run  the  WESLIB  arc  pro¬ 
gram  without  re-entering  the  data  in  the  WESLIB  format. 

26.  Both  arc  and  wedge  data  may  exist  together.  Either  both  sets  of 
data,  arc  and  wedge,  may  be  entered  in  the  same  format,  or  the  arc  data  may 
be  entered  in  one  format  and  the  wedge  data  in  another. 

27.  Data  for  a  particular  analysis  will  be  erased  each  time  the  user 
changes  the  format  of  data  entry.  For  example,  if  a  user  enters  5  neutral 
blocks  in  the  WESLIB  format  and  then  enters  another  neutral  block  in  the  Kansas 
City  format,  the  data  entered  in  the  WESLIB  format  will  be  replaced  by  the  data 
entered  in  the  Kansas  City  format.  In  this  case,  after  the  fifth  neutral 
block  has  been  entered,  the  program  will  request  the  sixth  neutral  block. 

When  the  user  enters  the  sixth  neutral  block  in  the  Kansas  City  format,  the 
program  will  erase  all  previous  neutral  blocks  and  store  the  present  neutral 
block  as  neutral  block  number  one. 

28.  In  the  Kansas  City  format,  the  current  failure  surface  can  be 
replaced  by  simply  typing  in  a  new  failure  surface,  as  long  as  the  new  surface 
is  entered  in  the  Kansas  City  format. 

29.  All  of  the  previous  options  discussed  are  summarized  below: 

«« - k-  Indicates  that  the  current  data  stored  by  a  particular 


format  will  be  replaced  by  data  entered  in  another  format.  Both  formats  must 
be  for  the  same  type  of  analysis,  either  arc  or  wedge. 

«  ►  -  Indicates  that  data  entered  for  the  arc  and  wedge  analyses 

are  stored  for  use. 


WESLIB  ARC  FORMAT 
A 


KANSAS  CITY  ARC  FORMAT 
Neutral  Block  Command  ■  NE 


WESLIB  WEDGE  FORMAT 
A 


KANSAS  CITY  WEDGE  FORMAT 


30.  The  NE  command  is  used  to  input  the  coordinates  of  the  end  points  of 
the  neutral  block  base  used  in  the  wedge  method  analysis.  The  program  responds 
to  the  NE  command  with: 


NEUTRAL  BLOCK  BASE  NUMBER  N 

LEFT  RIGHT  COMPUTATION 

X.  j,  *.  Y.  CONTROL 


-OR- 

ACTIVE  PASSIVE  COMPUTATION  ACT.  PASS.  VERT. 

X.  Y.  X.  Y.  CONTROL _ INC.  INC.  INC. 


where  N  is  the  neutral  block  number  assigned  by  the  program. 

31.  The  WESLIB  wedge  programs  may  store  up  to  25  neutral  blocks  for 
subsequent  analysis  by  repeating  the  NE  command,  while  the  Kansas  City  wedge 
program  stay  store  only  one  neutral  block.  If  desired,  other  data  may  be  modi¬ 
fied  and  used  with  the  same  neutral  block  data.  After  each  neutral  block  is 

defined,  it  is  displayed  with  the  soil  profile  as  shown  in  Figure  3 
ENTER  COHHAND  ( LEVEL  1) 

-NE 

NEUTRAL  BLOCK  BASE  NUNBER  1 

LEFT  R10HT  CONFUTATION 
X.  V,  X,  V,  CONTROL 

-  OR  - 

ACTIVE  PASSIVE  CONFUTATION  ACT.  PASS.  VERT. 

X.  V.  X.  V.  CONTROL  INC.  INC.  INC. 

•0  40#  -IS#  4##  1  S  S  • 

ENTER  CONHAND  (LEVEL  1) 


Figure  3.  Input  and  display  resulting  from  NE  command 


32.  The  coordinates  of  the  neutral  block  are  supplied  in  feet.  The  WESLIB 
programs  should  be  given  the  left  and  right  coordinates  of  the  neutral  block. 

The  Kansas  City  wedge  program  mist  be  given  the  coordinates  of  the  active  and 
passive  sides  of  the  neutral  block.  A  computation  control  number  is  required 
which  specifies  the  computations  to  be  made  according  to  the  following  code: 

Computations 

Control  No.  Program  Action 

1  Evaluates  safety  factors  for  after  construction,  sudden  draw¬ 

down,  partial  pool,  and  critical  pool  (The  embankment  is  satu¬ 
rated  below  the  before  drawdown  pool  elevation  for  the  sudden 
drawdown  case.) 

0  Same  as  for  number  1  except  that  the  phreatic  surface  defined 

by  command  PH  (paragraph  47)  data  is  used  in  the  drawdown 
computations  (The  elevation  of  the  lower  horizontal  pool  de¬ 
fined  by  the  phreatic  profile  must  be  the  same  as  the  after 
drawdown  pool  elevation.) 

-1  Evaluates  safety  factors  for  after  construction  and  steady 

seepage  R  and  S  strengths  (The  phreatic  profile  used  for  seepage 
computations  is  defined  by  data  input  by  the  command  PH;  the 
lower  elevation  of  the  phreatic  profile  must  be  the  same  as 
the  tailwater  elevation.) 

-2  Same  as  -1  except  that  the  phreatic  profile  is  horizontal  at 

the  headwater  elevation  out  to  the  shell,  coincident  with  the 
shell  down  to  the  tailwater  elevation  and  horizontal  at  the 
tailwater  elevation 

The  computation  control  flag  is  used  only  in  the  WESLIB  wedge  programs  but  is 
Included  in  the  input  list  for  the  Kansas  City  wedge  program  to  allow  the  user 
to  run  both  programs  from  the  same  input  data. 

33.  For  the  Kansas  City  wedge  program,  increments  for  the  active  and 
passive  side  of  the  neutral  block  plus  a  vertical  increment  for  the  neutral 
block  are  required.  If  zeros  are  input  for  any  of  the  increments,  no  search 
will  be  made  in  that  direction.  If  a  vertical  Increment  is  used  and  the  fail¬ 
ure  plane  is  inclined  within  the  neutral  block,  the  elevations  of  the  neutral 
block  are  adjusted  so  that  the  slope  of  the  failure  plane  remains  constant. 

ARC  Input  Command  ■  AR 

34.  The  program  responds  to  the  AR  command  with: 

ARC  1 

ARC  CENTER  AT  ARC  COMPUTATON 

DISTANCE,  ELEVATION,  radius,  control  flag,  xinc.  yinc.  rinc.  rmax 


35.  The  WESLIB  arc  program  may  store  up  to  25  arcs  for  subsequent 
analysis  by  repeating  the  AR  command,  while  the  Kansas  City  arc  program  may 
store  only  one  arc  for  analysis.  The  same  arc  data  may  be  used  repeatedly 
while  other  data  are  modified.  After  each  arc  is  input  it  is  displayed  as 
seen  In  Figure  4. 

ENTER  CONNAND  (LEVEL  I) 

-AR 

ARC  I 

ARC  CENTER  AT  ARC  CONFUTATION 

DISTANCE,  ELEVATION,  RADIUS,  CONTROL  FLAG,  XINC,  VINC.  RINC.  RRAX 
—30  500  90  1  5  5  S  0 

ENTER  CONNAND  (LEVEL  1) 


Figure  4.  Input  and  display  resulting  from  AR  command 

Arcs  which  do  not  Intersect  the  embankment  surface  and  those  having  intersec¬ 
tions  higher  than  the  arc  center  (overhanging  failure  surface)  will  produce 
error  messages. 

36.  The  user  supplies  the  distance  and  elevation  of  the  arc  center  (in 
feet) ,  the  arc  radius  (in  feet) ,  and  the  computation  control  flag  for  both 
the  WESLIB  and  Kansas  City  arc  programs.  For  the  Kansas  City  arc  program. 
Increments  must  be  supplied  for  the  coordinate  of  the  arc  center  and  the  arc 
radius.  If  a  zero  is  input  for  any  of  these  Increments,  searching  in  that 
direction  will  not  occur.  A  maximum  value  of  the  radius  that  will  be  used  in 
the  search  procedure  is  also  needed.  If  a  zero  is  input,  no  limit  will  be 
placed  on  the  radius. 

37.  A  computation  control  flag  must  be  input  which  selects  the  computa¬ 
tion  to  be  made  for  the  arc  being  entered.  The  computations  are  specified  by 
the  following  code: 


ragrosg  m  ^  »y  wg.Tivvi 


Computation 

Control  Flag  Program  Action 

1  Evaluates  safety  factors  for  effectiveness  after  construction, 

sudden  drawdown,  partial  pool,  and  critical  pool  (The  embankment 
is  saturated  below  the  before  drawdown  pool  elevation  for  the 
sudden  drawdown  case.) 

0  Same  as  for  number  1  except  that  the  phreatic  surface  defined  by 

phreatic  profile  data  is  used  in  the  drawdown  computations  (The 
elevation  of  the  lower  horizontal  pool  defined  by  the  phreatic 
profile  must  be  the  same  as  the  after  drawdown  pool  elevation.) 

-1  Evaluates  safety  factors  for  after  construction  and  steady  seep¬ 

age  R  and  S  strengths  (The  phreatic  profile  used  for  seepage 
computations  is  defined  by  command  PH  (paragraph  47);  the  lower 
elevation  of  the  phreatic  profile  must  be  the  same  as  the  tail- 
water  elevation.) 

-2  Same  as  -1  except  that  the  phreatic  profile  is  horizontal  at  the 

headwater  elevation  out  to  the  shell,  coincident  with  the  shell 
down  to  the  tallwater  elevation,  and  horizontal  at  the  tallwater 
elevation 

Although  the  computation  control  flag  is  used  only  in  the  WESLIB  arc  program, 
it  is  included  in  the  data  list  for  the  Kansas  City  arc  program  to  allow  the 
user  to  run  both  the  Kansas  City  and  WESLIB  programs  from  the  same  input  data. 
Arc  Generating  Command  -  GE 

38.  This  commend  applies  only  to  the  WESLIB  arc  program.  The  Kansas  City 
arc  program  generates  its  own  arcs  using  the  values  given  for  the  arc  incre¬ 
ments  described  under  the  AR  command  (paragraph  34) • 

39.  The  arc  generating  routine  produces  a  family  of  arcs  that  are  all 
tangent  to  a  horizontal  plane  and  pass  through  a  common  point.  The  program 
has  two  modes  of  operation,  selected  by  the  KASE  value.  KASE  is  a  variable 
used  to  select  the  stability  analysis  case  to  be  used.  The  operating  modes  and 
computations  set  by  each  KASE  value  are  discussed  in  the  following  paragraphs. 

40.  Arc  generating  mode.  The  generating  mode  calculates  slope  stability 
for  a  series  of  arcs,  starting  with  radius  RS  (see  paragraph  42,  page  19),  and 
increasing  the  radius  of  successive  arcs  by  DEL  until  radius  RF  is  used.  All 
arcs  in  the  group  are  tangent  to  a  plane  at  elevation  EL  and  pass  through  the 
point  XP,  YP.  (The  above  criteria  were  chosen  to  aid  in  investigating  a 
circular  failure  surface  that  passes  through  a  point  on  or  within  the  embank¬ 
ment  and  is  coincident  with  a  relatively  weak  horizontal  stratum.)  Program 
operation  is  unchanged  except  that  arcs  are  produced  automatically,  and  KASE 
takes  on  the  function  of  the  computation  control  flag. 
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41.  Arc  searching  mode.  The  searching  node  differs  from  the  generating 
■ode  in  several  respects. 

a.  The  program  stops  the  arc  generating  process  when  the  safety 
factor  computed  for  the  current  arc  is  greater  than  the  safety 
factor  computed  for  the  previous  arc  of  the  group.  The  effect 
of  this  feature  is  to  halt  the  generating  process  when  a  minimum 
safety  factor  has  been  found,  based  on  the  assumption  that  arcs 
having  longer  radii  will  produce  larger  safety  factors. 

Jb.  Only  one  stability  analysis  case  is  computed. 

£.  The  variable  KASE  is  used  to  select  the  stability  analysis  case 
to  be  used.  Only  values  2  through  6  may  be  used  for  this 
searching  mode. 

jl.  The  previously  established  delete  options  are  erased  (The 
delete  options  must  be  reset  via  command  PR  (paragraph  63) 
before  the  program  is  used  in  any  other  computation  mode) . 

Program  action  for  each  RASE  value  is  as  follows: 

KASE  _ Program  Action _ 

-2  Computes  after  construction,  steady  seepage  R  strength,  and  steady  seepage 
S  strength  cases;  Assumed  saturated-to-shell  conditions  below  the  head¬ 
water  elevation  for  seepage  computations 

-1  Same  as  -2  except  that  the  tailwater  elevation  and  phreatic  profile  data 
are  used  in  seepage  computations 

0  Computes  after  construction,  sudden  drawdown,  and  partial  pool  cases  and 
locates  the  critical  pool  elevation  (The  after  drawdown  pool  elevation 
and  phreatic  profile  data  are  used  in  the  sudden  drawdown  computations.) 

1  Same  as  0  except  that  saturated-to-shell  conditions  are  assumed  below 
the  before  drawdown  pool  elevation  for  the  sudden  drawdown  computations 

2  Computes  only  after  construction  case 

3  Computes  only  sudden  drawdown  case 

4  Computes  only  partial  pool  case 

5  Computes  only  steady  seepage  R  strength  case 

6  Computes  only  steady  seepage  S  strength  case 

Note  that  the  KASE  numbers  2  through  6  have  the  reverse  effect  of  the  same 
delete  options  (paragraph  65);  that  is,  they  allow  only  the  prescribed  computa¬ 
tion  rather  than  delete  one  and  allow  all  others. 

42.  The  program  responds  to  command  GE  with: 


ARC  GENERATING  PARAMETERS 


The  functions  of  the  eight  arc  generating  parameters  are  presented  below 


Parameter 

Hame  Used  For 

RASE  Computation  control 

XP(  TP  The  distance  and  elevation  coordinates,  respectively,  of  the  common 
point 

EL  The  elevation  of  the  horizontal  plane 

RS  The  radius  of  the  initial  arc  (The  arc  center  must  be  above  the 

highest  point  on  the  failure  surface;  that  is,  RS  must  be  greater 
than  (YP  -  EL).) 

DEL  The  difference  in  the  radius  of  successive  arcs 

RF  The  maximum  generated  arc  length 

DIR  Indicates  whether  arc  centers  are  on  the  left  (DIR  -  -1)  or  right 

right  (DIR  ■  1)  of  the  common  point 

43.  Changes  In  program  and  data.  Two  major  changes  take  place  when  the 
arc  generator  is  used. 

a.  All  arc  data  previously  stored  are  not  used. 

b.  Only  the  strength  selector  and  print  control  delete  options 
(numbers  1  and  8)  will  remain  unchanged. 

After  the  arc  generated  parameters  have  been  input,  the  first  arc  is  displayed 

as  seen  in  Figure  5. 

ENTER  CONNAND  (LEVEL  1) 

•GE 

ARC  GENERATING  PARANETERS 

KASE,  XP.  VP,  EL,  RS,  DEL,  RF,  DIR 
*S  -225  45*  41*  1**  5  120  1 

ENTER  CONNAND  (LEVEL  1) 


Figure  5.  Input  and  display  resulting  from  GE  command 


Water  Surface  Data 


44.  The  following  commands  are  used  to  establish  hydrostatic  loading 
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UU  v* 


«i mnmjy  «jl  vm  1  .hilm1 


conditions*  All  of  the  commands  apply 
PH  command  is  used  in  conjunction  with 
Pool  Input  Cowand  »  PO 

45.  The  program  responds  to  this 
POOL  EL. 


to  the  WESL1B  programs,  while  only  the 
the  Kansas  City  programs. 

command  with: 


GROUNDWATER  FOR  PARTIAL 

cmmrnss  CAsg.~wgE7‘" 


BEFORE 


AFTER 

DRAWDOWN. 


SEEPAGE 

HfeAMfAlflR. 


SEEPAGE 

TAILWAtER 


The  user  replies  with  elevations  for  the  pools.  Pools  elevations  must  reference 
the  same  elevation  datum  as  other  coordinate  data  (soil  profile,  phreatic  pro- 
file,  and  arc  center).  The  program  supplies  an  Initial  value  of  zero  for  the 
the  pool  elevations.  This  zero  value  will  be  used  in  all  computations  if  the 
pool  command  is  not  given. 

46.  The  function  of  each  pool  elevation  in  the  computation  procedure  is 
listed  below. 

a.  The  groundwater  elevation  is  used  in  the  after  construction 
computations.  The  program  uses  saturated  unit  weight  with  Q 
shear  strength  data  above  this  elevation  and  submerged  unit 
weight  with  Q  shear  strength  data  below  this  elevation.  Delete 
option  1  causes  R  strength  data  to  be  used  below  this  elevation 
and  Q  strength  data  above. 

b.  The  partial  pool  elevation  is  used  during  upstream  analysis 
(wedge  computation  control  value  of  1  or  0).  The  safety  factor 
is  computed  for  the  partial  pool  at  this  elevation  using  R  shear 
strength  data.  The  prograa  uses  saturated  unit  weight  above  the 
pool  and  submerged  unit  weight  below.  This  feature  allows  the 
user  to  study  pool  elevations  that  are  Independent  of  those 
chosen  by  the  automatic  critical  pool  location  procedure. 

c.  The  before  drawdown  elevation  is  used  during  upstream  analysis 
as  the  upper  elevation  for  sudden  drawdown  saturated-to-shell 
computations  (wedge  or  arc  computation  control  value  of  1).  This 
value  is  Ignored  when  the  sudden  drawdown  phreatic  surface  is 
defined  by  phreatic  profile  data. 

d.  The  after  drawdown  elevation  specifies  the  elevation  of  the  pool 
after  sudden  drawdown  has  taken  place.  This  value  is  used 
during  the  upstream  analysis  of  sudden  drawdown  computations 
(wedge  or  arc  computation  control  values  of  0  and  1).  This  value 
must  agree  with  the  lowest  elevation  of  the  phreatic  profile 
data  when  those  data  are  used  to  define  the  sudden  drawdown 
phreatic  surface  (wedge  or  arc  computation  control  value  of  0) . 

e.  The  headwater  elevation  is  used  during  downstream  analysis  as 
the  upper  pool  elevation  for  saturated-to-shell  steady  seepage 
computations  (wedge  for  arc  computation  control  value  of  -1). 

This  value  is  ignored  when  the  seepage  phreatic  surface  is 
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defined  by  phreatic  profile  data  (wedge  computation  control  value 
of  -2). 

f_.  The  tailwater  elevation  specifies  the  lower  pool  elevation  used 
”  in  downstream  analysis  of  steady  seepage  (wedge  or  arc  computation 
control  values  of  -1  and  -2).  This  value  must  agree  with  the 
lowest  elevation  of  the  phreatic  profile  data  when  they  are  used 
to  define  the  steady  seepage  phreatic  surface  profiles  (wedge  or 
arc  computation  value  of  -1)* 

The  pool  elevations  are  displayed  after  all  pools  have  been  input,  as  shown  in 
Figure  6. 

ENTER  CONHAND  (LEUEL  1) 

•PO 

POOL  EL. 

GROUND  UR TER  FOR  PARTIAL  BEFORE  AFTER  SEEPAGE  SEEPAGE 

CONSTRUCTION  CASE,  POOL,  DRAUDOUN,  DRAWDOWN.  HEADWATER.  TAILWATER 

•  499  439  479  459  479  459 

ENTER  COHNAND  (LEUEL  I) 


Figure  6.  Input  and  display  resulting  from  PO  command 
Phreatic  Profile  Input  Command  ■  PH 

47.  The  program  responds  to  this  command  with: 

PHREATIC  profile  points 

X(l).  Y(l).  X(2).  Y (2) 1  ...  X(N),  Y (N) 


The  user  replies  with  the  distance  (X)  and  elevation  (Y)  coordinates,  in  feet, 
of  the  points  that  describe  the  profile  of  either  the  sudden  drawdown  or  steady 
seepage  phreatic  surface. 

48.  The  phreatic  profile  points  must  be  in  ascending  numerical  order  by 
distance.  It  is  unlikely  that  one  profile  can  be  used  to  define  both  seepage 
and  drawdown  conditions,  although  the  program  will  attempt  to  use  whatever 
phreatic  profile  data  are  stored  in  the  analysis  of  either  or  both  conditions. 
The  best  practice  is  to  define  either  the  seepage  or  drawdown  profile  phreatic 
surface,  making  all  calculations  required,  and  then  define  the  other  phreatic 
surface  and  complete  the  remaining  calculations.  Figure  7  shows  the  input  and 
display  of  the  phreatic  profile  data.  Phreatic  surface  data  are  used  for  all 
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analyses  except  for  the  WESL1B  wedge  program  which  uses  the  piezometric  head 
data  to  calculate  uplift  along  the  failure  surface.  However,  not  all  of  the 
programs  interpret  the  phreatic  surface  in  the  same  manner.  Both  Kansas  City 
analysis  programs  interpret  the  phreatic  surface  data  in  the  same  manner  by 
requiring  the  phreatic  surface  to  be  described  the  entire  length  of  the  outer 
soil  profile.  If  a  level  pool  is  used,  only  one  point  needs  to  be  defined. 

The  WESLIB-ARC  program  also  requires  the  profile  to  be  defined  the  length  of 
the  outer  profile.  The  phreatic  data  must  also  follow  the  guidelines  (para¬ 
graph  45)  for  defining  pool  elevations.  The  WESLIB  wedge  program  only  requires 
the  phreatic  profile  to  be  defined  on  the  interior  of  the  outer  shell.  The  pool 
elevations  are  used  to  calculate  the  location  where  the  pool  elevations  inter¬ 
sect  the  outer  shell.  These  intersection  points  and  pool  elevations  described 
in  paragraphs  45-46  are  used  to  describe  the  phreatic  surface  exterior  to  the 
outer  soil  profile. 

ENTER  COHNAND  (LEVEL  1) 

•PH 

PHREATIC  PROFILE  POINTS 

X(l>.  Y(  1  ),  X(2 ),  Y<2 ).  ...  X(N).  V(H> 

—75  4SS  -SO  460  0  465  50  470 

ENTER  C0NHAND  (LEVEL  1) 


Figure  7.  Display  resulting  from  PH  command 
Plezometric  Head  Profile  Command  ■  PI 

49.  The  program  responds  to  this  command  with: 

PIEZOMETRIC  HEAD  PROFILE 

X(l).  Y(l).  H(I) .  X(2).  Y(2).  H(2).  ...  X(N) .  Y(N).  H(N) 

The  user  supplies  the  head  data  profile  points  consisting  of  the  distance  and 
elevation  of  each  point  and  the  plezometric  head,  in  feet,  at  that  point.  As 
previously  noted,  the  points  on  each  head  data  profile  must  be  recorded  in 
ascending  order  of  distance. 

50.  Should  more  than  one  line  of  data  be  required  for  the  head  of  any 
profile,  the  last  head  value  on  the  line  should  be  followed  by  a  comma  and  then 


a  carriage  return.  The  program  will  store  this  portion  of  the  profile  data. 
When  it  is  ready  for  additional  data,  the  program  will  type  an  equals  sign  on 
the  next  line.  Be  sure  to  wait  for  the  equals  sign  before  supplying  additional 
data.  Note  that  the  first  profile  must  define  the  phreatic  surface  (head 
values  must  be  zero).  Each  additional  profile  is  supplied  by  giving  command 
PI  followed  by  the  data  for  that  profile.  Figure  8  shows  the  display  of  the 
piezometric  head  profile  data. 

ENTER  COMMAND  (LEVEL  1) 
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Figure  8.  Display  resulting  from  PI  command 
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PART  III:  KANSAS  CITY  PROGRAM  COMMANDS 


51.  The  following  commands  are  for  use  with  the  Kansas  City  arc  and  wedge 
programs.  These  commands  may  be  used  repeatedly  to  vary  certain  parameters 
while  using  the  same  soil,  water,  and  failure  surface  data. 

Unit  Weight  of  Water  Command  ■  GA 

52.  The  default  value  for  the  unit  weight  of  water  used  in  the  program  is 
62.4  pounds  per  cubic  foot  (pcf*).  This  command  may  be  used  to  alter  the  value 
of  the  unit  weight  of  water.  The  program  responds  to  the  GA  command  with: 

ENTER  UNIT  WEIGHT  OF  WATER  (PCF). 

The  unit  weight  of  water  should  be  input  in  pcf. 

Slope  of  Active  Earth  Forces  Command  ■  SL 

53.  Information  about  the  failure  surface  used  in  the  analysis  is  input 
with  this  command.  The  program  responds  to  the  SL  command  with: 

SLOPE  DATA 

SLOPE  OF  ACTIVE  WIDTH  OF  DELTA  MAX.  NUMBER 

EARTH  FORCES _ SLICES _ THETA  OF  TRIAL  WEDGES 

(DEG) 

-0R- 

SLOPE  OF  ACTIVE  WIDTH  OF  MAX.  NUMBER 

EARTH  FORCES _ SLICES _ OF  TRIAL  ARCS 

54.  The  user  should  enter  the  slope  of  the  earth  forces  between  the 
active  wedge  and  central  block  as  a  positive  number.  The  width  of  the  slices 
used  to  divide  up  the  wedges  should  be  entered  in  feet.  The  increment  (Delta 
Theta)  by  which  the  angle  of  the  active  and  passive  wedge  failure  planes  are 
varied  should  be  entered  in  degrees.  If  a  zero  is  entered  for  the  maximum 
number  of  trials,  90  is  assumed. 

55.  If  the  slope  data  are  input  in  the  format  for  the  wedge  data,  the 
arc  data  are  also  satisfied. 


*  A  table  of  factors  for  converting  U.  S.  customary  (NON-SI)  units  of  mea¬ 
surement  to  metric  (SI)  units  is  presented  on  page  5. 


Soli  Strength  Code  Command  ■  SS 


56.  The  program  responds  to  the  SS  command  with: 
SOIL  STRENGTH  CODE 

ENTER  1,2, 3, 4, 5  FOR  Q,R,S,S&R,OR  S&(S+R)/2 


A  code  should  be  selected  which  corresponds  to  one  of  the  following: 
Strength  code  Failure  envelope  used 


1 

2 

3 

4 

5 


Use  Q-strength  (or  partial  consolidation) 
Use  R-strength 
Use  S-Strength 

Use  S  and  R  composite  envelope 

Use  S  and  (R+S)/2  Intermediate  envelope 


Percent  Consolidation  Command  -  PE 


57.  If  the  soil  strength  code  described  under  command  SS  is  chosen  to  be 
1,  the  percent  consolidation  for  each  soil  layer  may  be  entered.  The  program 
responds  to  the  command  PE  with: 

CONSOLIDATION  DATA 

ENTER  THE  PERCENT  CONSOLIDATION  FOR  EACH  SOIL  IN  ORDER 

m 

The  percent  consolidation  is  entered  as  a  percentage  with  no  decimal  point. 


PART  IV:  OPTIONAL  COMMANDS 


58.  The  following  commands  affect  either  the  program  output,  data  dis¬ 
play,  or  data  input.  All  of  the  optional  commands  apply  to  both  the  WESLIB 
and  Kansas  City  programs,  except  the  PR  command,  which  applies  only  to  the 
WESLIB  programs. 


Conversational  Mode  Command  ■  CO 


59.  The  full  conversational  mode  is  an  optional  feature  which  does  not 
become  effective  until  an  Invalid  command  or  the  CO  command  is  given.  The  CO 
command  causes  the  program  to  provide  additional  input  instructions  for  the 
data  input  command  codes. 

Delete  Conversational  Mode  Command  ■  NO 


60.  This  command  deletes  the  conversational  text  associated  with  the 
command  CO.  As  mentioned  previously,  the  teletype  output  controlled  by  command 
CO  is  underlined  in  this  report. 


Read  Data  from  an  Old  File  Command  **  RE 


61.  This  command  causes  the  program  to  request  the  following: 

SUPPLY  THE  NAME  OF  THE  INPUT  DATA  FILE 

The  user  must  supply  the  name  (4  to  8  characters)  of  the  file  that  contains 
the  input  data  and  then  a  carriage  return.  After  the  file  name  is  stored, 
the  program  will  change  from  the  restricted  conversational  (experienced  user) 
mode  to  the  unattended  mode  of  operation.  It  will  read  the  successive  lines 
of  data  in  the  input  file. 

62.  When  all  the  data  have  been  read,  the  program  will  return  to  the 
restricted  conversational  mode  and  request  the  next  command  from  the  terminal. 
At  this  point,  the  user  may  change  or  process  the  data  presently  in  storage 
or  read  and  process  data  from  another  file.  A  simple  example  using  this  mode 
follows: 


r  *'~3.cV4  * 


P 

i: 

$ 

I 


Vr 


ENTER  CON HAND  (LEVEL  1) 

•RE 

SUPPLY  NAHE  OF  INPUT  DATA  FILE 
-D6SL 


The  display  of  data  In  the  file,  DGSL,  are  shown  in  Figure  9. 


ENTER  COHHAND  (LEVEL  1) 


Figure  9.  Display  resulting  from  RE  command 


Program  Control  Command 


63.  This  command  is  used  only  when  one  or  more  of  the  following  standard 
values  or  option  Is  unacceptable  (items  _a  and  J>  apply  only  to  the  arc  program) ; 

a.  Earthquake  acceleration  is  0.05  g’s. 

b.  Number  of  slices  Is  20. 

c.  Computations  for  positive  computation  control  flag  are: 
after  construction,  sudden  drawdown,  partial  pool,  and 
critical  pool. 

d.  Computations  for  negative  computation  control  flag  are: 
after  construction,  steady  seepage  R  strengths,  and  steady 
seepage  S  strengths. 

e.  After  construction  analysis  uses  Q  strengths  at  the  failure 
surface  of  each  slice,  without  regard  to  the  groundwater. 

.£•  Program  output  includes  the  tabulation  of  failure  surface 
coordinates,  weight,  and  head  of  water  at  each  segment  of 
the  failure  surface. 

£.•  Program  output  includes  a  tabulation  of  the  input  data. 

64.  The  program  responds  to  command  PR  with: 


PROGRAM  CONTROL 


EARTHQUAKE  NUMBER  LIST  THE  NUMBER  OF  EACH 
G  LOAD,  OF  SLICES.  DELETE  OPTION  DESIRED 

The  user  supplies  the  earthquake  horizontal  acceleration  in  units  of  gravity, 
the  number  of  slices  (the  maximum  is  30)  required  for  compatibility  with  the 
arc  method  program,  and  the  number  for  each  delete  option  required  for  subse¬ 
quent  computations.  All  previously  established  delete  options  are  removed. 

65.  The  program  action  for  each  delete  option  is  shown  below  for  all 
programs  in  this  series: 

Number  Program  Action 

1  Uses  R  Instead  of  Q  strength  below  the  groundwater  elevation  for  after 
construction  case 

2  Deletes  computation  of  after  construction  case 

3  Deletes  computation  of  sudden  drawdown  case 

4  Deletes  computation  of  partial  and  critical  pool  cases 

5  Deletes  computation  of  steady  seepage  R  strength  case 

6  Deletes  computation  of  steady  seepage  S  strength  case 

7  Deltes  computation  of  critical  pool  location 

8  Deletes  failure  surface  coordinate  printing 

9  Deletes  plotting  of  soil  data  and  failure  surface  after  each  analysis 

10  Deletes  plotting  of  TEKPLOT  after  each  analysis 

The  PR  command,  as  used  for  deleting  the  critical  pool  calculations,  is 
illustrated  in  Figure  10. 

ENTER  COMMAND  (LEVEL  1) 

-PR 

PROGRAM  CONTROL 

EARTHQUAKE  NUMBER  LIST  THE  NUMBER  OF  EACH 
G  LOAD,  OF  SLICES,  DELETE  OPTIONS  DESIRED 
-.OS  20  7 


Figure  10.  Input  using  PR  command 


66.  This  command  provides  the  user  with  a  current  listing  of  the  unit 
weights,  moist  and  submerged,  and  the  angle  of  internal  friction  and  cohesion 
for  the  Q,  R,  and  S  strength  tests  for  each  soil.  If  Improper  data  have  been 
entered,  the  user  may  change  the  material  properties  with  an  ED  MA  command. 
The  use  of  the  TA  command  is  shown  in  Figure  11. 


ENTER  COMMAND  (LEVEL  1) 
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Window  Command  -  WI 


67.  This  command  allows  the  user  to  pick  any  rectangular  area  of  the 
display  and  magnify  it  to  fill  the  entire  screen.  This  provides  the  user  with 
all  the  details  necessary  to  check  the  input  data.  The  program  responds  to 
the  window  command  by  displaying  cross  hairs,  which  should  be  moved  to  the 
bottom  left-hand  corner  of  the  area  to  be  magnified.  A  character  must  then 
be  entered,  followed  by  a  carriage  return.  The  cross  hairs  will  reappear  and 
should  be  moved  to  the  upper  right-hand  corner  of  the  desired  area.  Another 
character  and  a  carriage  return  should  be  entered.  The  user  can  continue 
giving  the  WI  command  to  "window"  areas  of  the  previous  window.  To  redisplay 
the  entire  problem  again,  the  command  DI  should  be  entered.  Use  of  the  WI 
command  is  shown  in  Figure  12. 


Figure  12.  Display  resulting  from  WI  command 
Display  All  Data  Command  ~  PI 

68.  The  program  will  respond  to  this  command  by  erasing  the  screen  and 
displaying  all  defined  data  as  shown  in  Figure  13.  The  display  data  will  cover 
as  much  of  the  screen  as  possible,  using  the  same  X  and  T  scale  factors. 


Figure  13.  Display  resulting  from  DI  command 


Restart  Command  «■  RE 

69.  This  command  will  erase  all  failure  surface  data.  All  data  associated 
with  the  Kansas  City  commands  (paragraphs  51  through  55)  will  also  be  erased. 

Stop  Command  »  ST 

70.  If  the  user  desires  to  exit  the  program,  then  the  ST  command  may  be 
entered.  If  an  analysis  is  not  run  before  this  command  is  entered,  the  re¬ 
start.  file  will  not  be  updated. 
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PART  V:  EDITING  COMMANDS 

/,  « 

k  •> 

71.  The  following  commands  are  used  to  edit  the  input  data.  The  soil 
profile,  soil  properties,  phreatic  profile,  and  piezometric  profile  may  be 
modified. 


Insert  New  Soil  Command  -  IN 


72.  This  command  performs  the  following  functions: 

a.  Erases  all  data  for  soils  whose  numbers  are  between  N  and  M. 

b.  Sets  the  program  to  receive  a  new  soil  (properites  and  profile) . 
£.  Inserts  the  new  soil  between  numbers  N  and  M. 

d.  Renumbers  the  soils  (starting  with  1  for  the  first  soil  and 
continuing  in  steps  of  1  for  all  soils). 

e.  Sets  the  program  to  add  additional  soils  to  the  end  of  the 
soil  list  through  the  SO  command  (paragraphs  14-23) . 


73.  The  program  responds  to  the  command  IN  with: 
SOIL  INSERTION  NUMBERS 


SOIL  TO  FOLLOW  WILL  BE 


PLACED  BETWEEN  SOIL  N  AND 

~3EI T 


SOIL  M.  N  MUST  BE  LESS  THAN  M.  SOILS 
THROUGH  (M-l)  ARE  ERASED.  SUPPLY  VALUES  FOR  N  AND  M 


The  user  supplies  values  for  the  soil  numbers  N  and  M.  The  new  soil  will  be 
placed  between  soil  N  and  soil  M.  If  M  is  greater  than  N+l,  soils  N+l  through 
M-l  will  be  erased  and  the  new  soil  inserted.  If  M  is  greater  than  the  last 
soil  number,  then  all  of  the  soils  from  N+l  through  the  end  of  the  soil  list 
will  be  erased.  If  M  is  less  than  N,  an  error  note  will  be  printed.  Soil  N 
must  be  present,  or  an  error  note  will  be  printed. 

74.  The  program  replies  with: 

SOIL  (N+l)  PROPERTIES 


SOIL  PROFILE 

m 

where  (N+l)  is  the  number  assigned  to  the  soil  being  inserted.  Supply  the 
necessary  information  as  described  in  SO  command,  paragraphs  14-23.  After  an 
IN  command,  an  SO  command  may  be  used  to  add  soils  to  the  end  of  the  existing 
soil  list.  For  example,  if  there  are  6  soils  present  and  the  user  desires  to 


delete  soils  4  and  5  and  change  soil  3,  he  would  use  values  of  2  and  6,  respec¬ 
tively,  for  N  and  M,  After  recording  the  new  profile  and  properties  for  soil  3, 
the  program  would  renumber  all  soils,  and  in  so  doing  it  would  change  the 
number  of  soil  6  to  4.  If  the  user  gives  an  SO  command,  the  program  would 
store  that  soil  data  after  soil  4,  It  would  assign  the  number  5  to  that  new 
soil. 

Edit  Material  Properties  Command  «  ED  MA 

75.  The  program  responds  to  this  command  with: 

SOIL  NUMBER  TO  BE  CHANGED 

m 

The  user  replies  with  the  number  of  any  soil  previously  defined.  An  error 
message  will  be  typed  if  a  soil  having  this  number  is  not  present.  After  lo¬ 
cating  this  soil,  the  program  types: 

SOIL  i  PROPERTIES 

SATURATED  Q  TEST _ R  TEST _ 3  TEST 

UNIT  WT..  PHI.  COHESION.  PHI.  COHESION.  PHI.  COHESION 

-OR- 

SAT..  WT.  MOIST  WT.  Q  TEST  (1  TO  3)  R  TEST _ S  TEST 

PHI,  COHESION  PHI,  COHESION.  PHI.  COHESION 

m 

where  i  is  the  number  of  the  soil  requested.  The  user  responds  to  this  request 
with  the  new  soil  properties  as  described  in  the  section  on  command  SO.  All 
values  requested  must  be  input,  even  though  they  are  the  same  as  the  previously 
stored  data. 


Edit  Soil  Profile  Command  ■  ED  SO 

76.  The  program  responds  to  this  command  by  first  displaying  the  cross 
hairs.  The  user  must  move  the  cross  hairs  to  the  desired  soil  profile  point  and 
enter  a  character  and  a  carriage  return.  The  program  will  respond  with  the 
following: 

PRESENT  X,Y  COORDINATE  IS: 

13.00  14.00 

ENTER  NEW  COORDINATE 


The  program  will  change  all  soil  profiles  which  contain  the  X— Y  coordinate 
picked  by  the  cross  hairs  to  the  new  coordinate  Input.  The  screen  will  be 
erased  and  the  new  data  displayed  as  shown  in  Figures  14  and  15. 


ENTER  CONNAND  < LEVEL  1) 

•ED  SO 

PRESENT  X  AND  V  COORDINATE  IS: 

-te.ee  48e.ee 
INPUT  NEU  COORDINATE 
— ie  4se 


ENTER  CONNAND  (LEVEL  1> 


Figure  15.  Display  resulting  from  ED  SO  command  -  after  editing 
Edit  Phreatic  Profile  Command  ■  ED  PH 


77.  The  program  responds  to  the  command  ED  PH  by  displaying  the  cross 
hairs.  The  user  must  move  the  cross  hairs  to  the  desired  phreatic  profile 
point  and  enter  a  character  and  a  carriage  return.  The  program  will  respond 
with  the  following: 
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PRESENT  X  AND  Y  COORDINATE  IS: 

13.00  14.00 

ENTER  NEW  COORDINATE 

■I 

The  screen  will  be  erased,  and  the  new  data  will  be  displayed  as  shown  in 
Figures  16  and  17. 

ENTER  COMMAND  (LEVEL  1) 

•ED  PH 

PRESENT  X  AND  V  COORDINATE  ISi 
0«  465*00 

INPUT  NEU  COORDINATE 
—10  470 


-‘CROSS  HAIRS 


e_J tut _ _ 


Figure  16.  Editing  of  phreatic  profile  -  before  editing 


ENTER  COMMAND  (LEVEL  1) 


Figure  17.  Display  of  edited  phreatic  profile  -  after  editing 

Edit  Piezometric  Head  Profile  Command  ■  ED  PI 

78.  The  program  responds  to  this  command  by  displaying  the  cross  hairs. 
The  user  must  move  the  cross  hairs  to  the  desired  piezometric  head  point  and 


enter  a  character  and  a  carriage  return.  The  program  will  respond  with  the 
following: 

PRESENT  X  AND  Y  COORDINATE  IS: 

13.00  14.00 

ENTER  NEW  COORDINATE  AND  HEAD 


The  screen  will  be  erased,  and  the  new  data  will  be  displayed  as  shown  in 

Figures  18  and  19. 

ENTER  COMMAND  CLEUEL  1) 

«ED  PI 


lS^M  18<IM  is^oe 

Figure  18.  Editing  of  Piezometric  head  profile 
ENTER  COMMAND  (LEUEL  1) 


1SIM  1S^M  1S*.M 

Figure  19.  Display  of  edited  piezometric  head  profile 
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Delete  Neutral  Block  Command  *  DE  NE 


79.  When  this  command  is  entered,  the  program  will  respond  with: 

ENTER  NUMBER  OF  NEUTRAL  BLOCK  TO  BE  DELETED 

The  program  will  erase  the  neutral  block  whose  number  was  entered  and  renumber 
the  remaining  neutral  blocks. 


Delete  Arc  Command  =  DE  AR 


80.  When  this  command  is  entered,  the  program  will  respond  with: 

ENTER  NUMBER  OF  ARC  TO  BE  DELETED 

The  program  will  erase  the  arc  whose  number  was  entered  and  renumber  the  re¬ 
maining  arcs. 
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PART  VI:  EXECUTION  OF  DATA 

Execute  Wedge  Analysis  Command  »  RU  WE 


81*  This  command  causes  the  page  to  be  erased  and  the  program  to  calcu¬ 
late  the  slope  stability  using  the  wedge  method  found  in  program  SSW028  for  the 
problem  represented  by  the  current  display.  It  also  saves  all  data  input  in 
the  restart  data  file.  The  following  is  the  output  for  this  analysis: 


NEUTRAL  BLOCK  BASE  1 
-150.00.  400.00 


400.00 


AFTER  CONSTRUCTION  CASE  USED  0  STRGTH  BELOU  GR  UATER 

INITIAL  FACTO*  OF  SAFETY  •  8.77 


X 

-178.64 

-150.86 

-10.60 

0. 

66.43 


UEICHT 

59675. 

991667. 

100006. 

338148. 

0. 


UPLIFT  SOIL 
0.  1 
0.  1 
0.  1 
0.  1 
0.  0 


L  WEDGE 
F9  49558.63 
FP  82313.54 
S.F.  •  3.090 


N  9L0CK  n  UCDGE  TOTAL 

0.  -400000.00  -350447.37 

804095.25  124194.95  350603.73 


400.000 


DO  VOU  UANT  A  TEKPLOT  -  VES  OR  NO 

82.  The  above  output  shows  the  output  for  the  stability  analysis  of 
neutral  block  1.  This  output  Includes  the  following: 

a.  The  coordinates,  in  feet,  of  the  end  points  of  the  neutral 
block  base. 

b.  The  coordinates,  in  feet,  of  the  end  points  that  define  the 
line  segments  that  make  up  the  failure  surface. 

c.  The  weight,  in  pounds,  of  the  soil  above  each  failure  surface 
segment. 

,d.  The  head  of  water,  in  feet,  that  is  effective  at  each  end  point. 

e.  The  number  of  the  soil  through  which  each  failure  segment  passes. 

f.  A  tabulation  of  the  horizontal  components  of  the  driving  and 
resisting  forces  for  the  left  wedge,  neutral  block,  right  wedge, 
and  the  total  (Note  that  this  tabulation  is  for  the  forces  that 
were  calculated  for  the  last  trial  using  the  developed  friction 
angle). 

£.  The  safety  factor  for  this  problem  printed  as  the  last  line  in 
the  output  (Note  that  a  negative  sign  on  the  safety  factor  indi¬ 
cates  that  the  direction  of  failure  is  from  right  to  left). 


V 
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The  failure  surface  and  water  profile  are  shown  in  Figure  20 


Execute  Wedge  Analysis  With  Piezometric 
Head  Command  -  RU  PI 


83.  This  command  causes  the  program  to  calculate  the  slope  stability 
using  a  wedge  method  with  piezometric  heads  found  in  program  SSW39A  for  the 


problem  represented  by  the  current  display.  The  data  are  also  saved  in  the 
restart  data  file.  The  output  for  the  analysis  is  identical  to  the  SSW028 
output  except  the  uplist  is  described  as  head  (i.e.  piezometric  head).  The 


following  is  the  output  from  this  analysis: 

NEUTRAL  BLOCK  BASE  1 

-ise.ee.  4ee.ee  e.  .  4ee.ee 


X 

V 

UEICHT 

HEAD 

-180.62 

423.13 

105443. 

26.87 

-150.00 

400.00 

286427. 

50.00 

-100. 01 

400.00 

31. 

57.69 

-100.00 

400.00 

731170. 

57.69 

-10.01 

400.00 

100080. 

80.00 

0. 

400.00 

302152. 

72.11 

60.43 

480.00 

0. 

0. 

SOIL 


FD 

FR 


L  UEDGE 
102216.25 
26578.89 


N  BLOCK 

e. 

146278.88 


R  UEDGE 

-4eeeee.ee 

125183.76 


TOTAL 

-297783.75 

297968.92 


S.F.  -  2.832 


DO  VOU  UANT  A  TEKPLOT  -  VES  OR  NO? 

■ 

Execute  Arc  Analysis  Command  -  RU  AR 


84.  This  command  causes  the  program  to  calculate  the  slope  stability 
using  the  arc  analysis  method  found  in  program  SSA003  for  the  problem  repre¬ 
sented  by  the  current  display.  Data  are  also  saved  in  the  restart  data  file. 


POINT  A  POINT  B  FORCES  (KIPS) 


NO. 

RANGE 

ELEU, 

THETA 

RANGE 

1 

8. 

488.8 

58.8 

-158.8 

2 

5.8 

488.8 

58.8 

-158.8 

3 

-5.8 

488.8 

58.8 

-158.8 

4 

-18.8 

488.8 

58.8 

-158.8 

S 

-1^.8 

488.8 

58.8 

-158.8 

s 

-28.8 

488.8 

58.8 

-158.8 

7 

-25.8 

488.8 

58.8 

-158.8 

8 

-38.8 

488.8 

58.8 

-158.8 

9 

-35.8 

488.8 

58.8 

-158.8 

18 

-48.8 

488.8 

58.8 

-158.8 

11 

-45.8 

488.8 

58.8 

-158.8 

12 

-58.8 

488.8 

45.8 

-158.8 

13 

-55.8 

488.8 

45.8 

-158.8 

14 

-68.8 

488.8 

45.8 

-158.8 

15 

-65.8 

488.8 

45.8 

-158.8 

16 

-78.8 

488.8 

45.8 

-158.8 

17 

-75.8 

488.8 

48.8 

-158.8 

18 

-88.8 

488.8 

48.8 

-158.8 

19 

-85.8 

488.8 

48.8 

-158.8 

28 

-98.8 

488.8 

48.8 

-158.8 

21 

-95.8 

488.8 

48.8 

-158.8 

22 

-188.8 

488.8 

35.8 

-158.8 

23 

-185.8 

488.8 

35.8 

-158.8 

24 

-118.8 

488.8 

35.8 

-158.8 

2S 

-115.8 

488.8 

3S.8 

-158.8 

26 

-128.8 

488.8 

35.8 

-158.8 

27 

-125.8 

488.8 

38.8 

-158.8 

28 

-138.8 

488.8 

38.8 

-158.8 

29 

-135.8 

488.8 

38.8 

-158.8 

38 

-148.8 

488.8 

38.8 

-158.8 

31 

-145.8 

488.8 

38.8 

-1S8.8 

niNinun 

SAFETY 

FACTOR 

•  1.98 

ELEU. 

THETA 

ACTIUE 

CENTRAL 

PASS. 

S.F. 

488.8 

5.8 

246.3 

282.3 

44.6 

2.87 

488.8 

5.8 

249.2 

285.5 

43.7 

2.95 

488.8 

5.8 

243.6 

198.4 

45.5 

2.79 

488.8 

5.8 

248.8 

194.4 

46.5 

2.71 

488.8 

5.8 

237.  S 

198.1 

47.5 

2.63 

488.8 

5.8 

233.6 

185.2 

48.4 

2.56 

488.8 

5.8 

229.1 

179.9 

49.3 

2.58 

488.8 

5.8 

224.9 

172.8 

49.9 

2.44 

488.8 

S.8 

219.4 

166.7 

58.8 

2.39 

488.8 

5.8 

213.4 

168.1 

SI. 6 

2.34 

488.8 

5.8 

287.8 

153.2 

52.3 

2.38 

488.8 

5.8 

288.6 

146.2 

53.8 

2.26 

488.8 

5.8 

193.9 

138.9 

53.8 

2.22 

488.8 

5.8 

186.9 

131.4 

54.4 

2.19 

488.8 

5.8 

179.6 

123.7 

55.8 

2.16 

488.8 

5.8 

172.8 

11S.8 

55.5 

2.14 

488.8 

5.8 

164.7 

187.9 

S6.1 

2.11 

488.8 

5.8 

157.4 

188.2 

56.6 

2.88 

488.8 

5.8 

149.9 

92.3 

57.1 

2.86 

488.8 

5.8 

142.3 

84.4 

57.5 

2.84 

488.8 

5.8 

134.5 

76.4 

57.8 

2.83 

488.8 

5.8 

127.4 

68.8 

S8.3 

2.81 

488.8 

5.8 

128.3 

61.3 

58.8 

1.99 

488.8 

5.8 

113.1 

53.8 

59.1 

1.97 

488.8 

5.8 

186.4 

46.1 

59.2 

1.96 

488.8 

6.8 

98.9 

38.9 

59.4 

1.96 

488.8 

S.8 

91.9 

32.8 

59.9 

1.94 

488.8 

5.8 

8S.6 

25.3 

68.3 

1.93 

488.8 

5.8 

79.3 

18.7 

68.7 

1.91 

488.8 

5.8 

73.1 

12.2 

68.9 

1.98 

488.8 

5.8 

67.2 

6.8 

68.9 

1.98 

Execute  Kansas  City  Arc  Analysis  Command  ■  RU  AR 

86.  This  command  causes  the  program  to  calculate  the  slope  stability 
using  the  Kansas  City  arc  program.  The  analysis  Is  performed  on  the  problem 
represented  in  the  current  display.  The  output  from  the  Kansas  City  arc 
analysis  contains  the  number  of  each  trail  arc,  the  location  of  center  of 
arc,  radius  of  arc,  driving  and  resisting  forces, and  factor  of  safety  for 
each  trail  arc.  The  data  are  also  saved  in  the  restart  file.  The  following 
Is  the  output  from  this  analysis: 


NO. 

X 

V 

R 

DRI 

RES 

S.F. 

1 

-30.0 

500.0 

90.0 

186.8 

187.0 

4.03 

2 

-25.0 

see.e 

90.0 

192.0 

192.1 

4.31 

3 

-35.0 

soe.e 

90.0 

181.8 

181.6 

3.79 

4 

-40.0 

500.0 

90.0 

176.3 

176.2 

3.56 

S 

-45.0 

500. 0 

90.0 

170.6 

170.6 

3.35 

6 

-50.0 

500.0 

90.0 

164.9 

164.9 

3.16 

7 

-55.0 

500.0 

90.0 

159.7 

159.6 

3.00 

8 

-60.0 

500.0 

90.0 

154.3 

154.2 

2.86 

9 

-65.0 

see.o 

90.0 

148.5 

148. S 

2.73 

10 

-70.0 

500.0 

90.0 

142.4 

142.5 

2.61 

11 

-75.0 

see.e 

90.0 

136.3 

136.4 

2.50 

12 

-80.0 

see.o 

90.0 

130.4 

130.5 

2.42 

13 

-85.0 

500.0 

90.0 

124.2 

124.2 

2.34 

14 

-90.0 

500.0 

90.0 

117.4 

117.4 

2.27 

IS 

-95.0 

500.0 

90.0 

110.4 

110.4 

2.22 

16 

-100.0 

500.0 

90.0 

102.9 

102.9 

2.20 

17 

-105.0 

500.0 

90.0 

95.3 

95.3 

2.18 

18 

-110.0 

500.0 

90.0 

88.2 

88.2 

2.16 

19 

-115.0 

500.0 

90.0 

81.3 

81.3 

2.14 

20 

-120.0 

500.0 

90.0 

74.6 

74.6 

2.11 

21 

-125.0 

500.0 

90.0 

68.5 

68.5 

2.09 

22 

-130.0 

500.0 

90.0 

62.3 

62.3 

2.07 

23 

-135.0 

500.0 

90.0 

56.7 

56.6 

2.05 

24 

-140.0 

500.0 

90.0 

50.9 

50.9 

2.03 

25 

-145.0 

500.0 

90.0 

45.8 

45.8 

2.02 

26 

-150.0 

500.0 

90.0 

40.9 

40.9 

1.99 

27 

-155.0 

500.0 

90.0 

36.2 

36.3 

1.98 

28 

-160.0 

500.0 

90.0 

31.8 

31.8 

1.96 

29 

-165.0 

500.0 

90.0 

27.7 

27.7 

1.94 

30 

-170.0 

500.0 

90.0 

23.9 

23.9 

1.92 

31 

-175.0 

500.0 

90.0 

20.4 

20.4 

1.91 

32 

-180.0 

500.0 

90.0 

17.1 

17.1 

1.89 

33 

-185.0 

500.0 

90.0 

14.1 

14.1 

1.87 

34 

-190.0 

500.0 

90.0 

11.4 

11.4 

1.86 

3S 

-195.0 

500.0 

90.0 

9.0 

9.0 

1.84 

36 

-200.0 

500.0 

90.0 

6.9 

6.9 

1.83 

37 

-205.0 

500.0 

90.0 

5.1 

5.1 

1.81 

38 

-210.0 

500.0 

90.0 

3.5 

3.5 

1.80 

39 

-215.0 

500.0 

90.0 

2.2 

2.2 

1.78 

40 

-220.0 

500.0 

90.0 

1.2 

1.2 

1.77 

41 

-225.0 

500.0 

90.0 

0.5 

0.5 

1.76 

42 

-230.0 

500.0 

90.0 

0.1 

0.1 

1.74 

43 

-235.0 

500.0 

90.0 

NO  INTERSECTION 

MINI HUH  SAFETY  FACTOR  -  1.74 


v;v:v?t,:>i,v.v,.i« 
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PART  VII:  INPOT  DATA  FILE  FORMAT 


87.  The  format  of  the  data  in  the  Input  file  is.  in  all  respects  but  one, 
identical  with  that  supplied  by  a  user  who  is  working  with  this  program  in  the 
conversational  mode.  The  exception  is  that  line  numbers  are  required  for  each 
line  of  data.  Below  is  an  example  of  a  data  file.  Old  data  files  which  were 
used  for  the  slope  stability  programs  SSW028,  SSW039A,  and  SSA003  are  still 
valid  for  DGSLOPE. 


1*0  TEST  run  for  DGSLOPE 
110  SO 

120  125  115  30  0  30  0  30  0 

130  -300  400  -2SO  400  -10  480  110  480 

140  SO 

150  150  145  45  1000  30  2000  30  2S00  45  5000  4S  5000 
160  -300  400. 

170  110  400 
ISO  rc 

190  0  400  -1S0  400  1  9  5  0 
200  PO 

210  400  430  470  450  470  450 

220  PR 

230  .05  20  7 

240  M 

250  -30  500  90  1  5  5  5  0 
250  PI 

270  -250  450  0  -100  450  0  -10  490  0  110  490  0 
280  PI 

290  -250  300  150  -100  300  150  -10  300  190  110  300  180 


88.  Note  that  the  first  line  in  the  file  must  contain  the  title.  The 
commands  are  on  a  line  by  themselves.  They  are  followed  by  the  required  data 
on  the  next  line  or  lines.  For  instance,  line  110  contains  the  c  ind  SO  for 
soil  data  input.  This  is  followed,  on  line  120,  by  the  soil  properties  and,  on 
line  130,  by  the  soil  profile.  Although  this  profile  is  recorded  on  one  line, 
it  could  just  as  well  have  been  typed  on  two  or  more  lines  as  was  done  for  the 
second  soil  profile  (lines  160  and  170).  A  comma  will  allow  the  user  to  con¬ 
tinue  the  data  on  another  line. 


PART  VIII:  DRUM  PLOTS 


£ 

\ 

89.  Creation  of  drum  plots  is  accomplished  by  using  the  "Level  2" 
commands: 


IN  -  INITIALIZE 

ED  -  EDIT  SOIL  NUMBERS 

DN  -  DELETE  SOIL  NUMBERS 

AN  -  RESTORE  SOIL  NUMBERS 

TE  -  TEKPLOT 

EN  -  ENTER  TABLES 

DI  -  DISPLAY  TABLES 

WI  -  WINDOW  DISPLAY 

CH  -  CHANGE  XX 

RE  -  RETURN 

ST  -  STOP 

DR  -  DRUMPLOT 

These  commands  allow  the  user  to  select  the  desired  information  to  be  displayed 

on  the  drum  plots.  All  drum  plots  are  42  in.  long  and  21  in.  high. 


Initialization  Command  -  IN 


90.  The  initialization  phase  is  an  automatic  result  of  entering  the  drum 
plot  portion  of  DGSLOPE.  However,  this  phase  can  be  re-entered  at  any  time 
during  the  creation  of  drum  plots.  The  initialization  phase  allows  the  se¬ 
lection  of  up  to  10  analyses,  as  seen  below,  to  be  displayed  on  the  drum  plot. 


ENTER  UR  TO  1®  ANALYSES  TO  BE  PLOTTED. 
THERE  ARE  3  ANALYSES  STORED. 

ENTER  A  •  FOR  CURRENT  LISTING. 

•® 

ANALYSIS  •  t 

AC 

FACTOR  OF  SAFETY  •  3.09 

ANALYSIS  -  2 

SD 

FACTOR  OF  SAFETY  •  1.92 

ANALYSIS  •  3 

PP 

FACTOR  OF  SAFETY  •  2.44 

ENTER  UP  TO  1®  ANALYSES  TO  BE  PLOTTED. 

THERE  ARE  3  ANALYSES  STORED. 

ENTER  A  •  FOR  CURRENT  LISTING. 

•1 


Editing  of  Soil  Numbers  Command  -  ED 


91.  Each  line  segment  is  numbered  with  its  corresponding  soil  type. 
However,  even  though  this  is  informative,  it  does  not  always  result  in  a 
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desired  picture*  The  ED  command  allows  the  user  to  move  or  delete  the  soil 
numbers  to  generate  a  picture  desirable  to  him.  This  is  done  by  using  the 
cross  hairs  and  three  selected  characters  on  the  keyboard. 

92.  When  the  ED  command  is  entered,  the  screen  is  erased,  and  the  soil 
profiles  and  soil  numbers  are  displayed.  The  cross  hairs  then  appear  on  the 
screen.  The  valid  characters  are: 

E  -  End  Editing 
M  -  Move  Number 
D  -  Delete  Number 

A  soil  number  can  be  deleted  by  placing  the  cross  hairs  over  it  and  entering 
the  character  D.  A  soil  number  can  be  moved  by  placing  the  cross  hairs  over 
it  and  entering  M.  The  cross  hairs  then  reappear.  The  user  places  the  cross 
hairs  at  the  desired  location  for  the  soil  number  and  enters  any  character. 

This  process  continues  until  the  character  E  is  entered. 

Delete  Soil  Numbers  Command  -  DN 

93.  This  command  is  similar  to  the  ED  command,  except  that  entering  this 
command  will  remove  all  soil  numbers  from  the  plot  of  the  data. 

Restore  Soil  Numbers  Command  »  AN 

94.  This  command  will  restore  the  soil  numbers  deleted  by  the  DN  command. 

TEKPLOT  Command  ■  TE 

95.  The  TE  command  is  used  to  redisplay  the  drum  plot  on  the  graphics 
terminal  screen  after  editing  has  taken  place.  Figure  21  depicts  a  drum  plot 
on  the  screen. 


Figure  21.  Display  of  a  drum  plot  on  the  screen 


Enter  Table  Command  -  EN 

96.  The  EN  command  results  in  a  block  representing  the  soil  data  table 
and  a  block  for  either  a  wedge  data  table  or  an  arc  data  table,  depending  on 
the  type  of  analysis  at  Level  1  (Figure  22). 


Figure  22.  Display  resulting  from  EN  command 


97.  The  DI  command  displays,  as  shown  below,  the  contents  of  the  table 
entered  by  the  EN  (ENTER  TABLE)  command* 


NO.  XA 

VA 

THETA  A 

XR 

VR 

theta  b 

ACTIVE 

CENTRAL 

PASSIVE 

SF 

1  0. 

400.0 

50.0 

-150.0 

400.0 

5.0 

246.3 

202.3 

44.6 

2.87 

SOIL 

UNIT 

WEIGHT 

0 

TEST 

R  TEST 

S 

TEST 

HOIST 

SATURATED 

PHI 

COHESION 

PHI  COHESION 

PHI 

COHESION 

1 

115.00 

125.00 

30.00 

0. 

30.00  0. 

30.00 

0. 

2 

145.00 

150.00 

45.00 

30.00 

30.00 

1000.00 

2000.00 

2500.00 

45.00  5000.00 

45.00 

5000.00 

WINDOW  Command  WI  -  WI 


98*  This  command  Is  used  to  enlarge  a  portion  of  the  soil  data  using  the 
cross  hairs  and  three  selected  characters  on  the  keyboard.  When  the  WI  command 
Is  given,  the  screen  Is  erased  and  only  soil  profile  data  are  displayed.  The 
cross  hairs  then  appear.  The  valid  characters  are: 

W  -  Window 
T  -  Total  Plot 
C  -  Continue 

When  W  is  entered,  the  user  must  move  the  cross  hairs  to  the  lower  lefthand 
corner,  enter  any  character,  move  the  cross  hairs  to  the  upper  righthand  corner, 
and  then  enter  any  character.  The  screen  is  erased,  and  the  data  within  the 
window  are  displayed.  An  enlarged  portion  of  the  soil  data  resulting  from  the 
WI  command  is  shorn  in  Figure  23.  Entering  character  T  will  result  in  a  dis¬ 
play  of  the  entire  data.  The  character  C  returns  the  user  to  the  "Level  2" 
commands. 


Figure  23.  Display  resulting  from  WI  command 


Change  Soli  Table  Command  ■  CH  SO 

99.  The  location  of  the  soli  table  on  the  plot  can  be  changed  with  the 
CH  SO  command.  The  CH  SO  command  results  in  the  display  of  the  cross  hairs. 

The  user  can  then  move  the  cross  hairs  to  locate  the  new  upper  left-hand  corner 
of  the  soil  table.  The  user  can  enter  any  character  to  place  the  table  in  the 
new  corner. 

Change  Wedges  Table  Command  ■  CH  WD 


100.  The  CH  WD  command  changes  the  location  of  the  wedge  data  table  on 
the  plot.  Entering  this  command  results  in  a  display  of  the  cross  hairs.  The 
user  can  then  move  the  cross  hairs  to  locate  the  new  upper  left-hand  corner  of 
the  wedge  data  table.  The  user  can  enter  any  character  to  place  the  table  in 
the  new  corner. 

Change  Arc  Table  Command  -  CH  AR 


8 


'CAJ 


I 


lOljl  The  CH  AR  command  is  similar  to  the  CH  SO  and  CH  WD  commands,  except 
that  it  applies  to  the  arc  data  table. 

i 

I  Change  Tic  Interval  Command  ■  CH  TI 

i 

102.  This  command  results  in  the  following: 

"Enter  New  Distance  Between  Tic  Marks" 

This  allows  the  user  to  control  the  placement  of  the  tic  marks  on  the  drum  plot. 

Return  Command  -  RE 

103.  The  command  RE  returns  the  user  to  the  "Level  1"  commands. 

Stop  Command  ■  ST 

104.  The  ST  command  allows  the  user  to  exit  the  program. 


•  -  V.  AV.V.V 


Drum  Plot  Command  *«  DR 


m 


% 

sV 


105.  The  DR  command  results  In  a  series  of  questions  that  must  be  answered 
In  order  to  generate  a  drum  plot.  An  example  using  the  DR  command  and  the  re¬ 
sulting  series  of  questions  is  shown  below. 


ENTER  CONNAND  (LEVEL  TWO) 
•OR 


ENTER  I DENT  CARO  INFORNATION 
FOR  UESt  USERID, NANE 

FOR  NACONI  ACCOUNT  NUNIER. NANE, USER ID 
-lSDSRO.NP, 1 1RDKASLP 

INPUT  STATION  CODE  FOR  OUTPUT  (DO  IF  NOT  RENOTE) 

■RO 

ARE  CALCONP  ROUTINES  ON  SVSTEN  LIBRARY  (VES  OR  NO)? 
FOR  UESt  VES 
FOR  NACONI  NO 
-NO 

ENTER  LIBRARY  UHERE  CALCONP  ROUTINES  ARE  STORED 
FOR  NACONI  11RDKPLIB/UESTARL 
■UROKPLIB'UESTARL 

ENTER  LOCATION  TO  UHICH  YOUR  PLOT  SHOULD  BE  SENT 
•ADP.UES 

INPUT  PRIORITY  (S  OR  49) 

•5 

SNUNB >19280 


Recommended  Dse  Of  Program 


106.  An  e  gineer  will  get  results  from  this  program  much  more  efficiently 
by  using  an  Input  data  file.  The  interactive  commands  can  then  be  used  to  edit 
or  change  existing  data  and  control  the  analysis  process.  The  use  of  the 
Interactive  commands  for  building  a  new  data  file  can  be  very  time  consuming 

on  many  of  the  computers  presently  serving  the  Corps. 

107.  The  user  should  never  be  concerned  with  drum  plot  commands  until 
the  final  results  have  been  determined.  The  final  failure  surface,  l.e. , 
minimum  factor  of  safety,  is  plotted  with  failure  surfaces  which  have  higher 
factors  of  safety  and  indicate  that  the  failure  surface  with  minimum  factor  of 
safety  has  been  determined.  This  is  not  a  final  plot  for  a  design  memorandum 
plate  but  can  be  developed  into  a  final  plate  with  little  additional  drafting. 
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APPENDIX  A:  SUMMARY  OF  COMMANDS  FOR  LEVEL  1 


Function* 1  Area 


Description 


Used  By  Program 

Kansas  City  LMVD 

Programs  Program 


Failure  Surface  Data 


Daflnaa  Soil  Strengths  and  Prof Ilea 


Defines  Neutral  Block  For  Wedge  Analysis  Tes  Yea 

(Active  Wedge  (End  Points  for 

Passive  Wedge)  Neutral  Block) 


Defines  Arc  Failure  Surface 


Yes 

(One  Stunting 
Arc) 


Yea 

(Several  Different 
Arcs) 


Water  Surface  Data 


Generates  Arc 


Input  Pool  Elevation  Data 


Define  A  Pie tom*  trie  Head  Profile 


PH  Define  Phreatic  Profile  Yes 

GA  Define  Unit  Weight  of  Water  (Defaults  Yes 

62.5  pcf) 

Special  Kansas  City  Commands 

SL  Define  Scope  of  Active  Earth  Force  Yes 

SS  Define  the  Desired  Soil  Strength  Yes 

PE  Define  Percent  Consolidation  (only  used  Yes 


vlth  Q  strengths) 

Program  Control  Commands 

CO  For  Conversational  Output 

NO  Delete  Conversational  Output 

RE  Read  Old  Data  File  for  Input  Data 

PR  Program  Control  for  LMVD  Programs 

TA  List  Table  of  Soil  Properties 

WI  Define  Window  of  Display  with  Cross  Hairs 

DI  Display  Entire  Profile  Dsta 

RS  Restart  -  (Delete  All  Data) 

S7  Stop  Execution  of  Program 

Editing  Commands 

ED  MA  Edit  Materiel  Properties 

ED  SO  Edit  Soil  Profiles 

ED  PH  Edit  Phreatic  Profile 

ED  PI  Edit  Plesometrlc  Profile 

DE  NE  Delete  Neutral  Block 

DE  AR  Delete  Arc 

Execute  Stability  Analysis 

RU  KW  Executes  Kansas  City  Wedge  Analysis 

RU  KA  Executes  Kansas  City  Arc  Analysis 

RU  WE  Executes  LMVD  Wedge  Using  Pool 

Elevations  and  Phreatic  Profile  Data 
(SSW028) 

RU  PI  Executes  LMVD  Wedge  Using  Plecometrlc 
Head  Prof lisa  (SSW39A) 


Yea 

Yes 

No 

No 

No 


Ru  AR  Executes  LMVD  Arc  (SSA003) 


